'use strict';

/*eslint no-console:0*/

/**
 * 向开发人员提供警告，说明他们正在使用的方法已被弃用。
 *
 * @param {string} method 不推荐使用的方法的名称
 * @param {string} [instead] 使用的替代方法（如适用）
 * @param {string} [docs] 获取更多详细信息的文档URL
 */
module.exports = function deprecatedMethod(method, instead, docs) {
  try {
    console.warn(
      'DEPRECATED method `' +
        method +
        '`.' +
        (instead ? ' Use `' + instead + '` instead.' : '') +
        ' This method will be removed in a future release.'
    );

    if (docs) {
      console.warn('For more information about usage see ' + docs);
    }
  } catch (e) {
    /* Ignore */
  }
};
